How Organisation of Architecture Documentation Influences Knowledge Retrieval

In this chapter we report case studies in two companies to investigate how the use of file-based and ontology-based documentation influences AK retrieval (RQ4). A common approach to SA documentation in industry projects is the use of filebased documents. This approach offers a single-dimensional arrangement of the AK. AK retrieval from file-based documentation is efficient if the organisation of knowledge supports the needs of the readers; otherwise it can be difficult or impossible to retrieve the knowledge. The ontology-based approach offers a multidimensional organisation of AK by means of a software ontology and semantic wiki, whereas file-based documentation typically uses hierarchical organisation by directory structure and table of content. We conducted case studies in two companies to study the efficiency and effectiveness of retrieving AK from the different organisations of AK. We found that the use of better AK organisation correlates with the efficiency and effectiveness of AK retrieval. Professionals who used the AK organisation found this beneficial.